home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 1 / Gold Medal Software Volume 1 (Gold Medal) (1994).iso / graphics / povsrc20.arj / MACHINE / UNIX / UNIX.DOC < prev    next >
Text File  |  1993-09-30  |  5KB  |  105 lines
  1. This file contains the documentation specific to UNIX systems.  Due to the
  2. wide variety of UNIX systems available, POV-Ray may not compile directly
  3. as is.  Every effort has been made to make it compile on as many systems as
  4. we have access to.  If you have problems compiling, try checking with a
  5. local UNIX guru first.  If you still have problems, contact the POV-Ray team.
  6.  
  7. If you are trying to compile POV-Ray on an unsupported platform, the UNIX
  8. version is the best one to use as a base.
  9.  
  10.  
  11. Differences from original distribution:
  12.    The original distribution of POV-Ray is in ZIP format.  For UNIX,
  13.    this has been converted to compressed TAR format.  In addition, the UNIX
  14.    distribution of POV-Ray has CR-LF pairs converted to only LF's for text
  15.    files.  Otherwise, this distribution is identical to the ZIP
  16.    distribution.
  17.  
  18. Note: PLEASE SEE POVLEGAL.DOC.  The UNIX version in tar-compress format is an
  19.    officially supported format and can be distributed as is.  You MAY NOT
  20.    re-package the archive file or distribute any changes to it.  If you
  21.    do post it on a BBS or network, you must provide at least the scene
  22.    files and documentation files with the executables.  See POVLEGAL.DOC
  23.    for complete details.
  24.  
  25. Executables:
  26.    No executables are provided for the UNIX version of POV-Ray since there
  27.    are so many possible executable formats.  In general, however, UNIX
  28.    systems come bundled with a C compiler, so recompiling the source for
  29.    your target system shouldn't cause a problem. You may not distribute
  30.    an executable that you have compiled. It is for your personal use only.
  31.  
  32. Display Formats:
  33.    There are two different ways to create a UNIX system.  The first way has
  34.    no display options (i.e., it cannot display the image as it's rendering it).
  35.  
  36.    Alternatively, if you have X-Windows, you can compile in the X-Windows
  37.    drivers.  See the section on building the source.
  38.  
  39.    Additionally, there is some full-colour X Windows source in the VAX specific
  40.    files that are part of the POV source. See VAX.C and XWIND.C. You can use
  41.    VAX.C as a template for a new UNIX.C. XWIND.C is not VMS or MOTIF specific.
  42.  
  43.    Also see the note at the end of this file.
  44.  
  45. File Formats:
  46.    The default file format for UNIX is "dump" format (+fd).  Targa or
  47.    raw may be specified on the command line or in the povray.def file.
  48.  
  49. Building the source:
  50.    POV-Ray should compile as is with most ANSI or non-ANSI UNIX compilers.
  51.    No changes should be needed in the core of the raytracer.
  52.  
  53.    To compile POV-Ray from the original source, follow the following
  54.    instructions:
  55.  
  56.       1) copy the files in the "source" directory into a "build" directory
  57.       2) copy the files in machine/unix to the build directory
  58.           (note, if your archive is in ZIP format, you probably have CR-LF
  59.            pairs in the source code.  These should be translated to LF's
  60.            only before you compile)
  61.       3) rename config.h to config.h
  62.           (This file may need to be editted on a system by system basis)
  63.  
  64.       For the non-X-Windows version:
  65.       4) rename unix.mak to makefile
  66.  
  67.       For the X-Windows version,
  68.       4) rename xwindows.mak to makefile
  69.  
  70.       5) Type "make"
  71.  
  72.  
  73.    Your executable will be called povray.
  74.  
  75. Post-processing Images:
  76.    POV-Ray images can be post-processed using the same utilities as DKBTrace
  77.    used.  For UNIX systems, the PBM utilities are an excellent choice for
  78.    post-processing utilities.  The 'dump' format of POV-Ray is the same as
  79.    QRT format, so the QRTTOPPM utility can be used to convert these files
  80.    to PPM format.
  81.  
  82. Questions and problems in the UNIX version can be directed to David Buck.
  83.  
  84. David Buck
  85. Internet:   dbuck@ccs.carleton.ca
  86. CompuServe: 70521,1371
  87.  
  88. Questions and problems with the VAX/VMS X code can be directed to Chris Cason
  89. on Compuserve via mail or in the POV source section of GRAPHDEV. (currently 8).
  90.  
  91. He will continue to enhance this code and test it other machines.
  92. If you had to make any modifications to get it to compile, please let him know
  93. so that he may update the source accordingly. This particularly applies to
  94. the build files. By doing so, you will be helping others.
  95.  
  96. You may like to check the POV section of GRAPHDEV on Compuserve to see if there
  97. are updated X files, which may occur from time to time.
  98. Try scanning for the keyword XWINDOWS.
  99.  
  100. Expect to find a significantly enhanced X version in the near future.
  101. (Sometime in late 1993 or early 1994). This will include a Motif shell.
  102.  
  103. Chris Cason.
  104. CIS:100032,1644
  105. Internet:100032.1644@compuserve.com